home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / sptrfs.z / sptrfs
Encoding:
Text File  |  2002-10-03  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSPPPPTTTTRRRRFFFFSSSS((((3333SSSS))))                                                          SSSSPPPPTTTTRRRRFFFFSSSS((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SPTRFS - improve the computed solution to a system of linear equations
  10.      when the coefficient matrix is symmetric positive definite and
  11.      tridiagonal, and provides error bounds and backward error estimates for
  12.      the solution
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.      SUBROUTINE SPTRFS( N, NRHS, D, E, DF, EF, B, LDB, X, LDX, FERR, BERR,
  16.                         WORK, INFO )
  17.  
  18.          INTEGER        INFO, LDB, LDX, N, NRHS
  19.  
  20.          REAL           B( LDB, * ), BERR( * ), D( * ), DF( * ), E( * ), EF( *
  21.                         ), FERR( * ), WORK( * ), X( LDX, * )
  22.  
  23. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  24.      These routines are part of the SCSL Scientific Library and can be loaded
  25.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  26.      directs the linker to use the multi-processor version of the library.
  27.  
  28.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  29.      4 bytes (32 bits). Another version of SCSL is available in which integers
  30.      are 8 bytes (64 bits).  This version allows the user access to larger
  31.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  32.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  33.      only one of the two versions; 4-byte integer and 8-byte integer library
  34.      calls cannot be mixed.
  35.  
  36. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  37.      SPTRFS improves the computed solution to a system of linear equations
  38.      when the coefficient matrix is symmetric positive definite and
  39.      tridiagonal, and provides error bounds and backward error estimates for
  40.      the solution.
  41.  
  42. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  43.      N       (input) INTEGER
  44.              The order of the matrix A.  N >= 0.
  45.  
  46.      NRHS    (input) INTEGER
  47.              The number of right hand sides, i.e., the number of columns of
  48.              the matrix B.  NRHS >= 0.
  49.  
  50.      D       (input) REAL array, dimension (N)
  51.              The n diagonal elements of the tridiagonal matrix A.
  52.  
  53.      E       (input) REAL array, dimension (N-1)
  54.              The (n-1) subdiagonal elements of the tridiagonal matrix A.
  55.  
  56.      DF      (input) REAL array, dimension (N)
  57.              The n diagonal elements of the diagonal matrix D from the
  58.              factorization computed by SPTTRF.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSPPPPTTTTRRRRFFFFSSSS((((3333SSSS))))                                                          SSSSPPPPTTTTRRRRFFFFSSSS((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      EF      (input) REAL array, dimension (N-1)
  75.              The (n-1) subdiagonal elements of the unit bidiagonal factor L
  76.              from the factorization computed by SPTTRF.
  77.  
  78.      B       (input) REAL array, dimension (LDB,NRHS)
  79.              The right hand side matrix B.
  80.  
  81.      LDB     (input) INTEGER
  82.              The leading dimension of the array B.  LDB >= max(1,N).
  83.  
  84.      X       (input/output) REAL array, dimension (LDX,NRHS)
  85.              On entry, the solution matrix X, as computed by SPTTRS.  On exit,
  86.              the improved solution matrix X.
  87.  
  88.      LDX     (input) INTEGER
  89.              The leading dimension of the array X.  LDX >= max(1,N).
  90.  
  91.      FERR    (output) REAL array, dimension (NRHS)
  92.              The forward error bound for each solution vector X(j) (the j-th
  93.              column of the solution matrix X).  If XTRUE is the true solution
  94.              corresponding to X(j), FERR(j) is an estimated upper bound for
  95.              the magnitude of the largest element in (X(j) - XTRUE) divided by
  96.              the magnitude of the largest element in X(j).
  97.  
  98.      BERR    (output) REAL array, dimension (NRHS)
  99.              The componentwise relative backward error of each solution vector
  100.              X(j) (i.e., the smallest relative change in any element of A or B
  101.              that makes X(j) an exact solution).
  102.  
  103.      WORK    (workspace) REAL array, dimension (2*N)
  104.  
  105.      INFO    (output) INTEGER
  106.              = 0:  successful exit
  107.              < 0:  if INFO = -i, the i-th argument had an illegal value
  108.  
  109. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  110.      ITMAX is the maximum number of steps of iterative refinement.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  114.  
  115.      This man page is available only online.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.